package com.kitom.qqmap.api;

import com.kitom.qqmap.bean.address.QQmapAddrToGeoRequest;
import com.kitom.qqmap.bean.address.QQmapAddrToGeoResult;
import com.kitom.qqmap.bean.geocode.QQmapGeocodeGeoRequest;
import com.kitom.qqmap.bean.geocode.QQmapGeocodeGeoResult;
import com.kitom.qqmap.bean.iplocation.QQmapIpLocationResult;

/**
 * <pre>
 *  ip定位服务接口
 * </pre>
 * @author <a href="https://gitee.com/kitom">ki_tom</a>
 * @since 2021-01-12
 */
public interface QQIpLocationService {


    /**
     * 地址解析到坐标
     */
    String IP_SCV = "https://apis.map.qq.com/ws/location/v1/ip";


    /**
     * 逆地址解析
     * <pre>
     *   <a href="https://lbs.qq.com/service/webService/webServiceGuide/webServiceIp">文档地址</a>
     * </pre>
     * @param ip ip地址
     * @return {@link QQmapIpLocationResult}
     */
    QQmapIpLocationResult ipLoation(String ip);


}
